home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / dmedia / datman.z / datman
Encoding:
Text File  |  2002-10-03  |  15.8 KB  |  331 lines
  1.  
  2.  
  3.  
  4. DDDDAAAATTTTmmmmaaaannnn((((1111))))                                                            DDDDAAAATTTTmmmmaaaannnn((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      datman - play and record audio tapes in DAT drive
  10.      datman -cd - play audio CD in CD-ROM drive through audio hardware
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ddddaaaattttmmmmaaaannnn [[[[----aaaalllleeeerrrrtttt _s_o_u_n_d_f_i_l_e]]]] [[[[----ccccdddd]]]] [[[[----ddddeeeevvvv _d_e_v_i_c_e]]]] [[[[----ddddbbbbccccddddiiiirrrr _d_i_r]]]] [[[[----ddddbbbbppppaaaatttthhhh
  14.      _d_i_r,_d_i_r,...]]]]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _D_A_T_m_a_n is a program for playing audio tapes and CDs.  When called as
  18.      ddddaaaattttmmmmaaaannnn it works as a tape recorder.  When the ----ccccdddd option is specified,
  19.      _D_A_T_m_a_n works as a CD player.
  20.  
  21.    DDDDAAAATTTTmmmmaaaannnn ----ccccdddd
  22.      _D_A_T_m_a_n -_c_d plays audio CDs that are loaded in the CD-ROM drive.  The
  23.      audio data is read from the CD via the SCSI bus and is played through the
  24.      16-bit audio hardware of recent IRIS systems.  _D_A_T_m_a_n -_c_d can also copy
  25.      audio data into disc files.*
  26.  
  27.      _D_A_T_m_a_n -_c_d is different from _c_d_h_e_a_d_p_h_o_n_e_s(_2) which operates the CD-ROM
  28.      drive as a CD player, playing the audio through the headphone and line-
  29.      out jacks of the CD-ROM drive.
  30.  
  31.    DDDDAAAATTTTmmmmaaaannnn
  32.      _D_A_T_m_a_n plays and records digital audio tapes on the 4mm DAT drive.  The
  33.      tapes are compatible with those used in commercial DAT recorders.  The
  34.      audio data is read from the DAT via the SCSI bus and is played through
  35.      the 16-bit audio hardware of recent IRIS systems.  _D_A_T_m_a_n can also copy
  36.      audio data to disc files and can record audio data from disc files.*
  37.  
  38.      * Subject to copyright laws.
  39.  
  40. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  41.      ----aaaalllleeeerrrrtttt _s_o_u_n_d_f_i_l_e
  42.           specifies an alternate sound to use as the alert when error dialogue
  43.           boxes are popped up.  The file must be an AIFF or AIFF-C file.
  44.           _D_A_T_m_a_n searches for the file in the directory
  45.           /_u_s_r/_s_h_a_r_e/_d_a_t_a/_s_o_u_n_d_s/_p_r_o_s_o_n_u_s. To specify a file somewhere else
  46.           you must give the full path name.
  47.  
  48.      ----ddddbbbbccccddddiiiirrrr _d_i_r
  49.           specifies the directory in which to write new music catalog entries.
  50.           It defaults to ~/._c_d_d_b.
  51.  
  52.      ----ddddbbbbppppaaaatttthhhh _d_i_r,_d_i_r,...
  53.           specifies a set of directories to search for music catalog
  54.           information.  It defaults to ~/._c_d_d_b.
  55.  
  56.      ----ddddeeeevvvv _d_e_v_i_c_e
  57.           specifies the particular CD-ROM or DAT device to use, for example:
  58.           /_d_e_v/_s_c_s_i/_s_c_0_d_3_l_0 or /_d_e_v/_m_t/_t_p_s_0_d_2_n_s_v.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDAAAATTTTmmmmaaaannnn((((1111))))                                                            DDDDAAAATTTTmmmmaaaannnn((((1111))))
  71.  
  72.  
  73.  
  74.      ----ssssmmmm  displays only the transport control section of the window.
  75.  
  76.      ----nnnnooooffffoooorrrrkkkk
  77.           causes _D_A_T_m_a_n to not fork itself into the background.
  78.  
  79.      ----nnnnooooffffrrrraaaammmmeeeessss
  80.           causes _D_A_T_m_a_n to start up with timecode frame display disabled.
  81.  
  82.      ----ffffrrrraaaammmmeeeessss
  83.           causes _D_A_T_m_a_n to start up with timecode frame display enabled.
  84.  
  85. OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN
  86.      _D_A_T_m_a_n operates like many commercial CD and DAT players. Most operations
  87.      are straight forward.  See the on-line help for full information.  A few
  88.      operations need explanation.  The _P_r_e_v _P_r_o_g button moves the current
  89.      location to the start of the current program.  If play is within 2
  90.      seconds (on the CD, on DAT it is within approximately 10 seconds) of the
  91.      start of the program, the _P_r_e_v _P_r_o_g button moves the current location to
  92.      the start of the previous program.
  93.  
  94.      Random searchs may be accomplished using the _C_u_e button.  To search for a
  95.      specific program number, type the program number into the program number
  96.      field of the display and press the _E_n_t_e_r key or click the left mouse
  97.      button over the _C_u_e button. Searches to particular locations in timecode
  98.      may be made in a similar manner by typing the desired location into one
  99.      of the timecode fields.
  100.  
  101. TTTTIIIIMMMMEEEE CCCCOOOODDDDEEEESSSS
  102.      _D_A_T_m_a_n has three timecode displays.  The type of timecode shown in each
  103.      display can be selected using the option button below the display.
  104.  
  105.    CCCCDDDD
  106.      CDs have two time codes stored on them: _a_b_s_o_l_u_t_e time and _p_r_o_g_r_a_m time.
  107.      Timecodes are stored as three values: minutes, seconds and frames.
  108.      Absolute time is a continuously incrementing time code starting from zero
  109.      at the start of the disc.  Program time is time code that increments from
  110.      0 at the start of each program (aka track) on the CD.  _D_A_T_m_a_n -_c_d can
  111.      also compute and display the _r_e_m_a_i_n_i_n_g time.  That is the time left to
  112.      play.
  113.  
  114.    DDDDAAAATTTT
  115.      DATs can have as many as three time codes recorded on them:  _a_b_s_o_l_u_t_e
  116.      time, _p_r_o_g_r_a_m time and _r_u_n_n_i_n_g time.  It is permissible and probable that
  117.      no time codes will be recorded on the tape.  Timecodes are stored as four
  118.      values: hours, minutes, seconds and frames.  Absolute time is a
  119.      continuously incrementing time code starting from zero at the start of
  120.      the tape.  Program time is time code that increments from 0 at the start
  121.      of each program (aka track) on the tape.  Running time is a continuously
  122.      incrementing time code starting from some arbitrary value at the start of
  123.      the tape.  A variation of running time is used to record SMPTE time code.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DDDDAAAATTTTmmmmaaaannnn((((1111))))                                                            DDDDAAAATTTTmmmmaaaannnn((((1111))))
  137.  
  138.  
  139.  
  140. RRRREEEECCCCOOOORRRRDDDDIIIINNNNGGGG CCCCDDDD////DDDDAAAATTTT TTTTOOOO DDDDIIIISSSSKKKK
  141.      To record to a file from CD or DAT, select _O_p_e_n "_R_e_c_o_r_d _T_o" _f_i_l_e from the
  142.      file menu. This will bring up a small recording control window, with
  143.      buttons to turn file recording on and off ("file record" and "file
  144.      stop"). When the CD or DAT is playing while "file record" is pressed,
  145.      DATman will be writing to the current file. Multiple "clips" of sound may
  146.      be appended into the same file by going back and forth between the "file
  147.      record" and "file stop" modes. Select _C_l_o_s_e _f_i_l_e when done. The popup
  148.      window will ask you to confirm that you wish to close the file. Once the
  149.      file has been closed, nothing more can be appended to it.
  150.  
  151. RRRREEEECCCCOOOORRRRDDDDIIIINNNNGGGG OOOONNNNTTTTOOOO DDDDAAAATTTT
  152.      _D_A_T_m_a_n can make recordings compatible with commercial DAT recorders.  DAT
  153.      supports three sample rates: 48kHz, 44.1kHz and 32 kHz.  _D_A_T_m_a_n will not
  154.      record at any other sample rate.  _D_A_T_m_a_n can record from either the audio
  155.      hardware or from an AIFC file on hard disc.  When the input source is the
  156.      audio hardware, the actual source and sample rate are set via the _A_u_d_i_o
  157.      _C_o_n_t_r_o_l _P_a_n_e_l (see _a_p_a_n_e_l(_1)).  When the source is a disc file, the file
  158.      content determines the sample rate.
  159.  
  160.      To record from a file, select _O_p_e_n "_R_e_c_o_r_d _F_r_o_m" _f_i_l_e from the file menu.
  161.      All recordings made with the file open will start from the beginning of
  162.      the file, and proceed until either the entire file is recorded to DAT, or
  163.      "Stop" is pressed. When done, select _C_l_o_s_e "_R_e_c_o_r_d _F_r_o_m" _f_i_l_e from the
  164.      File menu.
  165.  
  166.      At present _D_A_T_m_a_n has only limited support for recording subcodes.  It
  167.      records absolute time code, program numbers and start-IDs.  When the
  168.      record button is pressed _D_A_T_m_a_n determines the current location in
  169.      absolute time code and current program number.  It increments the program
  170.      number and records the new program number and the start-id bit for the
  171.      first 300 frames. It increments absolute time every frame and records it.
  172.      If the tape is at the beginning, _D_A_T_m_a_n records a program number of one
  173.      and resets absolute time to zero.  When _D_A_T_m_a_n detects more than 2
  174.      seconds of silence during recording, it automatically increments the
  175.      program number.
  176.  
  177. MMMMUUUUSSSSIIIICCCC CCCCAAAATTTTAAAALLLLOOOOGGGG
  178.      The music catalog stores titles, artists and program information for CD
  179.      and DAT tapes.  When a CD or DAT is inserted in the drive, _D_A_T_m_a_n
  180.      searches the music catalog for an entry containing catalog information
  181.      for that recording.  If it finds one, it displays the information in its
  182.      large display panel.  Data from the recording's table of contents is used
  183.      as the key for searching the music catalog.  Very few DATs (even pre-
  184.      recorded ones) have a table of contents so _D_A_T_m_a_n will only rarely be
  185.      able to match a tape.
  186.  
  187.      New information is added to the catalog simply by typing it into the
  188.      appropriate fields of _D_A_T_m_a_n'_s display.  The catalog currently holds the
  189.      title of the recording, the artist's name and a title for each program on
  190.      the recording.  _D_A_T_m_a_n allows you to enter a different artist name for
  191.      each program.  The artist name for program one becomes the artist name
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DDDDAAAATTTTmmmmaaaannnn((((1111))))                                                            DDDDAAAATTTTmmmmaaaannnn((((1111))))
  203.  
  204.  
  205.  
  206.      for the whole recording.  It will be displayed for all programs without a
  207.      per-program artist name.  If an artist name is entered for any program
  208.      other than one, it will be displayed only while that program is played.
  209.  
  210.      The format of the music catalog is different from that previously used by
  211.      _c_d_p_l_a_y_e_r(_1) in order to facilitate creation of shared, distributed music
  212.      catalogs.  Existing catalogs can be converted to the new format using the
  213.      command _c_d_d_b_c_v_t(_1).
  214.  
  215.      When looking for a catalog entry, _D_A_T_m_a_n searches a list of directories.
  216.      The default list is the single directory ~/._c_d_d_b.  An alternate list can
  217.      be specified by either a command line option, an X resource or the shell
  218.      environment variable CDDB_PATH.  The command line overrides the X
  219.      resource which overrides the environment variable.  All of these methods
  220.      take as their value, a string which is a comma-separated list of
  221.      directories.
  222.  
  223.      When _D_A_T_m_a_n needs to create a new music catalog entry, it has to pick a
  224.      single directory.  The default directory is ~/._c_d_d_b.  An alternate
  225.      directory can be specified by either a command line option, an X resource
  226.      or the shell environment variable CDDB_WRITE_DIR.  The command line
  227.      overrides the X resource which overrides the environment variable.
  228.  
  229. XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  230.      All the command line options can also be set via X resources.  A command
  231.      line option will override the corresponding X resource setting.  The
  232.      class name is DDDDAAAATTTTmmmmaaaannnn. The instance name is the program name so it's
  233.      either ddddaaaattttmmmmaaaannnn or ccccddddmmmmaaaannnn.  _D_A_T_m_a_n recognizes the following resources.
  234.  
  235.      aaaalllleeeerrrrtttt      takes a string specifying the name of the sound file to use as
  236.                 the alert tone. The default is _i_n_s_t_r/_d_r_m__c_l_a_v_e._a_i_f_f.
  237.  
  238.      aaaauuuuttttooooFFFFoooorrrrkkkk   is a boolean specifying whether _D_A_T_m_a_n should fork itself into
  239.                 the background. The default is _T_r_u_e.
  240.  
  241.      ccccddddppppllllaaaayyyyeeeerrrr   is a boolean specifying whether _D_A_T_m_a_n should work as a CD
  242.                 player.  The default is _F_a_l_s_e.
  243.  
  244.      ddddaaaattttaaaabbbbaaaasssseeeeCCCCDDDDiiiirrrr
  245.                 takes a string which is the path name of the directory in
  246.                 which to create new music catalog entries.
  247.  
  248.      ddddaaaattttaaaabbbbaaaasssseeeePPPPaaaatttthhhh
  249.                 takes a string which is a comma-separated list of directories
  250.                 to search for music catalog entries.
  251.  
  252.      ddddeeeevvvviiiicccceeee     is the device to use.  As a DAT player the default is
  253.                 /_d_e_v/_n_r_t_a_p_e.  As a CD player the default is _N_U_L_L.  This
  254.                 default makes _D_A_T_m_a_n -_c_d use the first CD-ROM drive found by
  255.                 _g_e_t_i_n_v_e_n_t(_2).
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. DDDDAAAATTTTmmmmaaaannnn((((1111))))                                                            DDDDAAAATTTTmmmmaaaannnn((((1111))))
  269.  
  270.  
  271.  
  272.      ssssmmmmaaaallllllllDDDDiiiissssppppllllaaaayyyy
  273.                 is a boolean specifying whether the window should show just
  274.                 the small transport control section or the full _D_A_T_m_a_n
  275.                 display.  The default is _F_a_l_s_e.
  276.  
  277.      ffffrrrraaaammmmeeeessss     is a boolean specifying whether the application should display
  278.                 frames by default. The default is _F_a_l_s_e.
  279.  
  280. FFFFIIIILLLLEEEESSSS
  281.       ~/.cddb       default music catalog
  282.  
  283. BBBBUUUUGGGGSSSS
  284.      The music catalog feature is not yet implemented for tapes.  _D_A_T_m_a_n does
  285.      not yet make the necessary corrections to the frame number when
  286.      displaying SMPTE time code recorded in the running time field.
  287.  
  288. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  289.      cddbcvt(1), cdplayer(1), CDintro(3A), DTintro(3A)
  290.  
  291. AAAAUUUUTTTTHHHHOOOORRRR
  292.      Mark Callow
  293.  
  294. AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  295.      The author is indebted to Doug Cook and Erik Fortune for their enormous
  296.      contributions to DATman.
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.